Motivation

Improve agent-readability and discovery for the documentation site. The agentic-seo --output-dir dist/public score improves from 61/100 (C) before to 97/100 (A) after.

Summary

• Add public agent discovery artifacts, including AGENTS.md, agent-permissions.json, and a compact agent.html entry point
• Publish well-known API routes for the API catalog, agent skill, permissions, and agent instructions
• Expand mppx skill metadata with capabilities, inputs, constraints, and documentation links
• Section and trim llms.txt so the short index stays under the 5K-token target
• Add Copy for AI and Markdown affordances to key documentation pages
• Add explicit titles to blog and services pages for cleaner generated metadata

Key design considerations

• Keep the generated llms.txt rewrite in Vite so Vocs remains the source generator while the emitted artifact is optimized for agents
• Serve the rewritten llms.txt during local development when a build artifact exists, so local audits match production output
• Use static agent.html as a low-noise HTML bridge for scanners and agents without changing the Vocs runtime route model
• Preserve existing documentation structure and add only agent-facing discovery surfaces